home *** CD-ROM | disk | FTP | other *** search
/ BBS Toolkit / BBS Toolkit.iso / gt_power / chnge200.zip / CHANGE.DOC next >
Text File  |  1989-12-16  |  22KB  |  542 lines
  1.  
  2.  
  3.  
  4.  
  5.  
  6.  
  7.  
  8.  
  9.         CHANGE: v2.00                                     by Stephen de Plater
  10.         December 16, 1989                               GTPN Net Address 302/1
  11.  
  12.  
  13.  
  14.  
  15.  
  16.  
  17.  
  18.                                         CHANGE
  19.                                  by Stephen de Plater
  20.                                 GTPN Net Address: 302/1
  21.                                  Voice: +61 2 977-3075
  22.                                  Data: +61 2 977-2013
  23.  
  24.  
  25.  
  26.  
  27.         ======================================================================
  28.         0.                           REVISION LIST
  29.         ======================================================================
  30.  
  31.         VERSION:    Release Date:       Comments:
  32.         -------     ------------        --------------------------------------
  33.  
  34.         1.10        May 21, 1988        GT14   sensitive   --   color   added.
  35.                                         Pathnames  removed,  replaced  by area
  36.                                         numbers.
  37.  
  38.         1.11        May 24, 1988        BLUSH! A fix for a  bug which has been
  39.                                         lurking for MONTHS, and no-one saw it!
  40.                                         (I don't  mind when  it ignores  other
  41.                                         people, but when  it refuses to change
  42.                                         MY password, that's serious!)
  43.  
  44.         1.12        May 24, 1988        Oh  dear! Two  revisions  in one  day,
  45.                                         they're  becoming  even  more frequent
  46.                                         than    revisions    to    a   certain
  47.                                         (excellent) external protocol driver!
  48.  
  49.                                         Added Standard Command Line Interface.
  50.                                         Added   one   optional   command  line
  51.                                         parameter [/m] -- force monochrome.
  52.  
  53.         1.20        May 1, 1989         Vastly upgraded  password supervision.
  54.                                         A  number  of auxiliary  programs have
  55.                                         been  added  to   this  archive   (see
  56.                                         below).
  57.  
  58.  
  59.  
  60.  
  61.                                      >> page 1 <<
  62.  
  63.  
  64.  
  65.  
  66.  
  67.  
  68.  
  69.         CHANGE: v2.00                                     by Stephen de Plater
  70.         December 16, 1989                               GTPN Net Address 302/1
  71.  
  72.  
  73.  
  74.                                         A  new registration  scheme is  now in
  75.                                         place.
  76.  
  77.         1.21        May 17, 1989        A small cosmetic change in the options
  78.                                         displayed when changing  passwords (to
  79.                                         match   the    same   adjustment    in
  80.                                         GREETING).   Users   are   no   longer
  81.                                         prompted for the number of a suggested
  82.                                         password if  they  have  not  had  any
  83.                                         suggested for them.
  84.  
  85.                                         A  bug  existed  which rejected  every
  86.                                         password  attempted   by  users   with
  87.                                         single  names  only  (no  last  name).
  88.                                         Fixed!
  89.  
  90.         2.00        December 16, 1989   GT15 version released.
  91.  
  92.  
  93.         ======================================================================
  94.         1.                             COPYRIGHT
  95.         ======================================================================
  96.  
  97.         CHANGE is not placed in  the Public Domain. The copyright is  retained
  98.         and the software is provided on licence:
  99.  
  100.         You are  free to use  and make as many  copies of this  program as you
  101.         wish.  You may also give it away to any nodelisted GT Sysop who  wants
  102.         it, provided:
  103.  
  104.                1.   No fee is charged.
  105.                2.   This archive is distributed intact.
  106.                3.   You  register  the  package  with  an  OZNET  registration
  107.                     centre.
  108.  
  109.         Beta code  should be  treated exactly  as full  releases are  treated.
  110.         That is,  beta code may  also be distributed  to any nodelisted  Sysop
  111.         without restriction.   You should be aware  of course, that  beta code
  112.         may not be as refined as the full release  versions would be, and what
  113.         you see there may change when the beta tag is removed.
  114.  
  115.  
  116.  
  117.  
  118.  
  119.  
  120.  
  121.                                      >> page 2 <<
  122.  
  123.  
  124.  
  125.  
  126.  
  127.  
  128.  
  129.         CHANGE: v2.00                                     by Stephen de Plater
  130.         December 16, 1989                               GTPN Net Address 302/1
  131.  
  132.  
  133.  
  134.         ======================================================================
  135.         2.                           REGISTRATION
  136.         ======================================================================
  137.  
  138.         A  new  registration   scheme  now  applies  to  all  OZNET  software.
  139.         Regardless of  any previous  registration, this  program now  requires
  140.         individual installation for each BBS using it.
  141.  
  142.         There  is  still  NO fee  involved  at  all. DO  NOT  send  any money!
  143.         Registration  simply  involves obtaining  from  me  a CRC  code  which
  144.         matches  your BBS name.   You  may do  this at any  of the  four OZNET
  145.         registration centres:
  146.  
  147.                Kangaroo Korner          302/001   Stephen de Plater
  148.                The Black Hole           302/003   Ken Thompson
  149.                TSUNAMI! Catch the Wave  006/000   Chet Wilkinson
  150.                Control Systems          071/001   Ed Cavender
  151.  
  152.         If you are in  the nodelist then you will  be able to register  direct
  153.         online at  any of those  centres or via  mail in  the correct form  to
  154.         OZRobot at  any of those centres.   See the  included OZRobot document
  155.         for details.   If you are  not in the net  you will need  to apply via
  156.         private netmail or message  to Sysop at any of the  centres.  Whatever
  157.         way you  do it you will need to supply  the full (case sensitive) name
  158.         to which you want the program registered.
  159.  
  160.         You will also need to obtain  the OZINSTAL program which performs  the
  161.         actual installation.   OZINSTAL is not included in this  archive.  You
  162.         should look for OZINST11.ZIP.
  163.  
  164.  
  165.         ======================================================================
  166.         3.                              PURPOSE
  167.         ======================================================================
  168.  
  169.                          (Or what does this thing do anyway?)
  170.  
  171.         CHANGE is a door  program for GT Power BBS Systems. It allows users to
  172.         change
  173.  
  174.         1.     Their City/State,
  175.         2.     Their Phone number, or
  176.         3.     Their Password.
  177.  
  178.  
  179.  
  180.  
  181.                                      >> page 3 <<
  182.  
  183.  
  184.  
  185.  
  186.  
  187.  
  188.  
  189.         CHANGE: v2.00                                     by Stephen de Plater
  190.         December 16, 1989                               GTPN Net Address 302/1
  191.  
  192.  
  193.  
  194.         ======================================================================
  195.         4.                               USAGE
  196.         ======================================================================
  197.  
  198.         To use change, simply install it as a door much like this:
  199.  
  200.                          @echo off 
  201.                          gtdrwy
  202.                          doorway [various params] change.exe [various params]
  203.  
  204.         For the user, all that is  necessary is to open the door and  pick the
  205.         options.
  206.  
  207.         Any or all of the  three fields may be changed,  and at any stage  the
  208.         user  has the  option of saving  the changes  or quitting back  to the
  209.         board with the changes unsaved.
  210.  
  211.  
  212.         ======================================================================
  213.         5.                      COMMAND LINE PARAMETERS
  214.         ======================================================================
  215.  
  216.         There are three command line options.
  217.  
  218.          1.    /M   Force Monochrome.   With this  option, Ansi graphics  will
  219.                     not  be used  even if  GT14 is detected  and the  user has
  220.                     specified Ansi graphics on.
  221.  
  222.          2.    /Lnn The minimum length of password allowed  on this system.  I
  223.                     don't consider 4 character passwords  secure!  The default
  224.                     here is 6.   If  you choose a  number above 8  it will  be
  225.                     reset  down to  8.  That  is, you cannot  demand a minimum
  226.                     password length  of 15  characters!   This is  required so
  227.                     that  the  automatic   password  suggestion  feature  will
  228.                     produce passwords which can actually be used.
  229.  
  230.          3.    /T   Tight security.   With  this switch  on the  algorithm for
  231.                     determining  "is  similar  to"  when  checking  against  a
  232.                     password  previously  used,  is  tighter.    Without  this
  233.                     parameter the rule  is that  the new password  may not  be
  234.                     contained within any password previously  used, and no old
  235.                     password may be contained within the  new.  When this flag
  236.                     is enabled no sequence of 5 characters in the new password
  237.                     may  be contained  in any password  previously used.   The
  238.                     nett effect of this is that  without tight security a user
  239.  
  240.  
  241.                                      >> page 4 <<
  242.  
  243.  
  244.  
  245.  
  246.  
  247.  
  248.  
  249.         CHANGE: v2.00                                     by Stephen de Plater
  250.         December 16, 1989                               GTPN Net Address 302/1
  251.  
  252.  
  253.  
  254.                     with a  password of  say MYPASSWD1  would be  permitted to
  255.                     change it  to MYPASSWD2,  whereas with  tight security  ON
  256.                     that change  would  be  flagged  as "is  similar  to"  and
  257.                     rejected.
  258.  
  259.                     The  number  of characters  checked  in  this way  may  be
  260.                     varied.  The default is  5, which is  minimum allowed (and
  261.                     below which the feature turns itself off).  You can change
  262.                     it  by specifying  a number  with this parameter  (e.g. to
  263.                     relax it to 7  characters [the higher the number  the more
  264.                     relaxed the checking], you would use /T7).
  265.  
  266.  
  267.                     SPECIAL FILES USED
  268.                     ------------------
  269.  
  270.                     There are two  special files used  and maintained by  both
  271.                     CHANGE  and GREETING.   One  contains user names  and last
  272.                     change dates only.  The other contains a log of usernames,
  273.                     change dates, and old and new passwords.  This second file
  274.                     is encrypted and hidden.  The  encryption key is chosen by
  275.                     the  programs and is different for each  BBS.  That is, if
  276.                     you DID manage to  get hold of my copy of  this file, your
  277.                     copies of the programs could not read it!  These files are
  278.                     maintained by PASSMNT1.EXE and PASSMNT2.EXE respectively.
  279.  
  280.                     The contents of these files can be examined.  SHOWPASS.EXE
  281.                     examines  the  first  file, and  SHOWPL.EXE  examines  the
  282.                     second.    Neither  of these  programs  will  transmit ANY
  283.                     confidential  information over a phone line.   All four of
  284.                     these programs stamp the GT.LOG each time they are run.
  285.  
  286.                     These programs are supplied only with the CHANGE program.
  287.  
  288.                     There is another file  which is also used, if  present (in
  289.                     the  LAN directory  or  the GTPATH  directory  if the  LAN
  290.                     directory is not  defined).  DEADPASS.BBS is  a pure ASCII
  291.                     file containing, one  entry per line, passwords  which are
  292.                     not allowable on your system.  Any password which contains
  293.                     any one of these  lines will be rejected.  For  example, I
  294.                     don't think that  "PASSWORD" is a very secure password, so
  295.                     I have placed "PASSWORD" in my  DEADPASS.BBS.  I have also
  296.                     placed  "KANGA" there, so  any derivative of  the BBS name
  297.                     will  also be  rejected.   This file  may have  up  to 100
  298.                     entries.
  299.  
  300.  
  301.                                      >> page 5 <<
  302.  
  303.  
  304.  
  305.  
  306.  
  307.  
  308.  
  309.         CHANGE: v2.00                                     by Stephen de Plater
  310.         December 16, 1989                               GTPN Net Address 302/1
  311.  
  312.  
  313.  
  314.                     Nothing   special  is  required  to  enable  the  password
  315.                     supervision functions of  GREETING and  CHANGE.  Once  the
  316.                     MKPSCHNG program has been run (see below) both  CHANGE and
  317.                     GREETING will detect  that fact and take  over supervision
  318.                     functions from that point.
  319.  
  320.  
  321.         ======================================================================
  322.         6.                              COLOURS
  323.         ======================================================================
  324.  
  325.         Change  is sensitive to  the colours which  the GT  is using.   If you
  326.         don't  like the colours  you see,  just remember  that you  chose them
  327.         <grin>.
  328.  
  329.  
  330.         ======================================================================
  331.         7.                        AUXILIARY PROGRAMS
  332.         ======================================================================
  333.  
  334.         Five  auxiliary  programs are  supplied  with  CHANGE.   They  are all
  335.         associated  with  the  password supervision  functions  of  CHANGE and
  336.         GREETING.
  337.  
  338.         In order to run ALL FIVE MUST be OZNET registered.
  339.  
  340.          1.    MKPSCHNG.EXE
  341.                ============
  342.  
  343.                This  program should be run ONCE  ONLY!  Its entire function is
  344.                to generate  the first  of the special  files mentioned  above.
  345.                The presence of  this file  is the key  which enables  password
  346.                supervision for both CHANGE and GREETING.  When this program is
  347.                run  it  generates a  file which  contains  for each  user, the
  348.                username,  and a  date/time stamp, (the  date/time of  the last
  349.                password change).  Since this information is not known to begin
  350.                with, the file  is initialised with  the date/time of the  last
  351.                logon for each  user.  That's why  you should only ever  run it
  352.                once.  This  file (once generated) is  maintained automatically
  353.                by both CHANGE and GREETING.
  354.  
  355.                MKPSCHNG has no parameters.
  356.  
  357.  
  358.  
  359.  
  360.  
  361.                                      >> page 6 <<
  362.  
  363.  
  364.  
  365.  
  366.  
  367.  
  368.  
  369.         CHANGE: v2.00                                     by Stephen de Plater
  370.         December 16, 1989                               GTPN Net Address 302/1
  371.  
  372.  
  373.  
  374.          2.    PASSMNT1.EXE
  375.                ============
  376.  
  377.                Having  said that much,  this program also  maintains that same
  378.                file.  Its  entire job is  to remove from  the file records  of
  379.                users who are no longer in the USER file.   So, if you delete a
  380.                user this program completes the process by removing that user's
  381.                name from this file.
  382.  
  383.                PASSMNT1 has no parameters and should  be run regularly as part
  384.                of a maintenance batch file.  (I run it daily).
  385.  
  386.  
  387.          3.    PASSMNT2
  388.                ========
  389.  
  390.                This program  maintains the  other  file (which  is hidden  and
  391.                encrypted).  This  file is a log  which contains one entry  for
  392.                each password change.  The purpose of this program is to delete
  393.                old entries from this log.  No user will be allowed to re-use a
  394.                password which  is listed against his name in this log, or even
  395.                to use a similar password.
  396.  
  397.                PASSMNT2 has one optional  parameter (/S) which can be  used to
  398.                set the  "stale" time.  The default is  180 days.  This program
  399.                deletes all entries older than this from the log.  It should be
  400.                run regularly as part of a  maintenance batch file.  (I run  it
  401.                daily).
  402.  
  403.  
  404.          4.    SHOWPASS.EXE
  405.                ============
  406.  
  407.                This program displays (on the local console ONLY -- it will NOT
  408.                allow ANY  output  to be  sent  over a  phone line)  the  name,
  409.                current password, and last  change date/time of each user.   Of
  410.                course, if  you are  using DOORWAY  2.05 in  the direct  screen
  411.                write  mode, then  you will  fool this  program also.   In that
  412.                case, it CAN be run remotely and the results seen.  Be warned!
  413.  
  414.  
  415.  
  416.  
  417.  
  418.  
  419.  
  420.  
  421.                                      >> page 7 <<
  422.  
  423.  
  424.  
  425.  
  426.  
  427.  
  428.  
  429.         CHANGE: v2.00                                     by Stephen de Plater
  430.         December 16, 1989                               GTPN Net Address 302/1
  431.  
  432.  
  433.  
  434.          5.    SHOWPL.EXE
  435.                ==========
  436.  
  437.                This  program displays  the password  change  log.   Again, the
  438.                display will go ONLY to the  local console, NO information will
  439.                be sent over  a phone  line (although the  same comments  apply
  440.                here as for SHOWPASS above).
  441.  
  442.                For each password change  the date and time, the  username, the
  443.                old password (changed from), the  new password (changed to) and
  444.                a flag which  indicates whether or  not the change was  forced,
  445.                (an 'F' in the last column),  is displayed.  Forced changes are
  446.                those required by  GREETING, changes made by CHANGE  (which are
  447.                not forced) are marked with a '-' character.
  448.  
  449.  
  450.                PASSMNT1, PASSMNT2, SHOWPASS,  and SHOWPL all stamp  the GT.LOG
  451.                file each time they are run.
  452.  
  453.  
  454.         ======================================================================
  455.         8.                            LIMITATIONS
  456.         ======================================================================
  457.  
  458.         There is only one  practical limitation with this series  of programs.
  459.         If the number of users in  your default area on your BBS  exceeds 1500
  460.         some  internal  tables  may  well  overflow  and  cause  unpredictable
  461.         results.  This limitation does not apply to CHANGE itself, but only to
  462.         some of the  auxiliary programs.  It  this limitation poses a  serious
  463.         problem for you  (that is, if  you have  a BBS with  a HUGE number  of
  464.         users) I guess I can work on a way around this one for you.
  465.  
  466.  
  467.         ======================================================================
  468.         9.                         ACKNOWLEDGEMENTS
  469.         ======================================================================
  470.  
  471.         Both CHANGE and GREETING when changing passwords will, if requested by
  472.         the  user, suggest  a series of  passwords which  may be used.   These
  473.         passwords, each eight characters long, are formed by randomly choosing
  474.         two  words of 4 characters from  a list of over  1000.  There are over
  475.         1.5 million possibilities.  This feature  was suggested by John Della-
  476.         Torre from 302/0, "The Poet's Dilemma."
  477.  
  478.  
  479.  
  480.  
  481.                                      >> page 8 <<
  482.  
  483.  
  484.  
  485.  
  486.  
  487.  
  488.  
  489.         CHANGE: v2.00                                     by Stephen de Plater
  490.         December 16, 1989                               GTPN Net Address 302/1
  491.  
  492.  
  493.  
  494.         ======================================================================
  495.         10.                           DISCLAIMER
  496.         ======================================================================
  497.  
  498.         Q:         What kind of guarantee comes with this software?
  499.  
  500.         A:                    *** ABSOLUTELY NONE!!! ***
  501.  
  502.         If you break it you get to keep both halves!
  503.  
  504.         I take  no responsibility at all for what this  software may do on any
  505.         computer other than my own. If you use it you do so at your  own risk.
  506.         All that I am prepared to say about it is that it works fine here (and
  507.         I can see no  good reason why it should not also  work fine everywhere
  508.         else also -- but ....)
  509.  
  510.         By using this program you accept these conditions.
  511.  
  512.  
  513.         ======================================================================
  514.         11.                             ENJOY!
  515.         ======================================================================
  516.  
  517.         At least, I hope you do!
  518.         Stephen
  519.  
  520.         (Revd. Stephen de Plater
  521.         1 Kangaroo St.
  522.         MANLY 2095
  523.         AUSTRALIA)
  524.  
  525.  
  526.  
  527.  
  528.  
  529.  
  530.  
  531.  
  532.  
  533.  
  534.  
  535.  
  536.  
  537.  
  538.  
  539.  
  540.  
  541.                                      >> page 9 <<
  542.